Reticulum Community Wiki

Micron Document

Welcome • About • Search

Blackhole

4.8 KB • ⇊ 2 parts • ⤓ Micron 4.8 KB • ⤓ HTML 20.2 KB

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

Manual: Blackhole Management ↗

The blackhole system allows operators and users to block unwanted identities at the transport layer.

Any announces from blocked identities will be silently dropped, preventing them from being propagated through your node and for other nodes to reach their destinations through you (or your network segment).cite-ref-1[1]

Note: There is no way to globally block or censor an identity in Reticulum networks, as long as someone is willing to provide transport for it.

Contents

• Usage

• Federation

• Publishing

• Subscribing

• See also

• References

Usage

The rnpath utility can be used to manage the blackhole list of an instance. To specify which instance to mange the blackhole list for, use the --config=<config dir> option.

To add an identity to the blackhole list:

rnpath --blackhole <identity> --duration <hours> --reason "<reason>"

--duration and --reason are optional, defaulting to forever for no particular reason.

For example:

rnpath --blackhole 3a4f8b9c1d2e3f4g5h6i7j8k9l0m1n2o --duration 24 --reason "Excessive announces"

To remove an identity from the blackhole list:

rnpath --unblackhole <identity>

To see all identities in the blackhole list:

rnpath --blackholed

Federation

To maintain an up-to-date list across many nodes on a large network, you can subscribe to blackhole lists maintained and published by trusted peers or a central authority that you manage yourself.cite-ref-2[2]

Note: This relies on the trust relationship between the subscriber and the publisher. By subscribing to a source, you are implicitly trusting that source to only block relevant identities.

There are plans to integrate the blackhole system with network identities in the future, adding a layer of cryptographic trust to the federation process.

Publishing

To publish a node's blackhole list, set publish_blackhole = true in the [reticulum] section of the RNS instance's configuration file.

Subscribing

To subscribe to blackhole lists, add blackhole_sources = <identity, identity, …> with a comma separated list of identities to the [reticulum] section of the RNS instance's configuration file.

To see which lists you are subscribed to and their contents:

rnpath --blackholed-list